home *** CD-ROM | disk | FTP | other *** search
/ Games of Daze / Infomagic - Games of Daze (Summer 1995) (Disc 1 of 2).iso / x2ftp / msdos / docs / inter45e / intervue.doc < prev    next >
Encoding:
Text File  |  1995-01-25  |  5.3 KB  |  104 lines
  1.  
  2.                                INTERVUE V1.5
  3.                                January, 1995
  4.               Copyright 1992,95 Bob Williamson CIS 76570,2752
  5.  
  6.   INTERVUE is a viewer for the Interrupt List maintained by Ralf Brown.  
  7.   The program is Public Domain Software and may be freely copied and 
  8.   distributed.  The Interrupt List is avaliable for downloading from
  9.   CompuServe and numerous other BBS's.  The files are named INTnnA.ZIP,
  10.   INTnnB.ZIP, and INTnnC.ZIP (nn = current release no.).  
  11.   
  12.   INTERVUE is provided as a 'no frills' alternative to the commercial 
  13.   Interrupt List viewers.  The primary design critera were compatibity with 
  14.   all operating environments and small executable size.  No modification to 
  15.   the Interrupt List files is required for using the viewer.
  16.  
  17.   Version 1.4a contains an improved search alogrithm for the List entries,
  18.   case insensitive search, expanded technical documentation, and a Windows
  19.   Icon.
  20.  
  21.   INTERVUE is designed to be backward and foward compatible with the 
  22.   Interrupt List releases, subject to the following constraints: 
  23.  
  24.         The Summary File format must be compatible with release 32.
  25.         The individual List files size must not exceed 7 segments (458Kb).
  26.         The number of List files must not exceed 15.
  27.         The INTERRUP.A file header format must be consistent with release 32.
  28.         
  29.   To install INTERVUE, first copy the Interrupt List files, INTnnA.ZIP and 
  30.   INTnnB.ZIP, to a subdirectory on the fixed disk and UNZIP them.  Next, use 
  31.   INTPRINT to create the Summary File (INTERRUP.SUM) with the following 
  32.   command:
  33.  
  34.         INTPRINT -sINTERRUP.SUM -m -i INTERRUP.A nul
  35.  
  36.   Copy INTERVUE to the Interrupt List directory and execute the program.  
  37.   The INTERRUP.SUM file serves as the menu for accessing the function 
  38.   descriptions contained in the Interrupt List files (INTERRUP.?).  To run 
  39.   INTERVUE from a search path, add the following command to the AUTOEXEC.BAT 
  40.   file:
  41.  
  42.         set intervue = drv:\path
  43.  
  44.   The 'drv:\path' is the drive and path where the Interrupt List files are
  45.   located.  INTERVUE may then be placed in any active search path.
  46.  
  47.   The following keys are active within the INTERVUE text display window:
  48.   Home, End, PageUp, PageDn, UpArrow, DnArrow, Tab, Shift-Tab, Esc, F1, 
  49.   F2, F3, Ctrl-C, & Enter.
  50.  
  51.   INTERVUE is written in 8086 assembler, uses conventional memory (640Kb)
  52.   only, compatible with DOS 2.0 & >, RSIS compliant (DESQview aware), and 
  53.   is compatible with both mono and color video.  Requires 3Mb disk space
  54.   for the Interrupt List files (unzipped).  INTERVUE has no command line
  55.   parameters, does not use a setup file, and makes no disk writes.
  56.  
  57.                           Search Alogrithm:
  58.  
  59.   At initialization, the environment is checked for a path to the Interrupt
  60.   List files.  If none is found, the default path is used.  INTERRUP.A is 
  61.   opened and the first 1680 bytes of text are read to build an array mapping 
  62.   Int, Fct, & Sub to the INTERRUP file extension.  Next, INTERRUP.SUM is read 
  63.   into the file buffer and displayed as a menu.  When a function is selected 
  64.   (Enter), the List file with the Int, Fct, & Sub is read into the buffer and 
  65.   searched for a match.
  66.  
  67.   The search string is formed from the Summary file entry by re-creating
  68.   the List file description line (three format variations).  The List
  69.   file description line does not contain the Fct & Sub, so a verify string 
  70.   is created to check the List file dashed line above the description for 
  71.   Int, Fct & Sub.  A hit is returned from verify if either a match is 
  72.   found, or if Int, Fct & Sub are absent from the dashed line above the 
  73.   description (some with Int only are missing).  The verify compare allows 
  74.   List file formatting fluctuations of + or - 5 bytes.  
  75.  
  76.   The only observed search problem occurs from identical entries (Int, Fct,
  77.   Sub, & description) in the Summary file.  The search will always find the 
  78.   first of these entries in the List file.  Use of F3 (next match) will 
  79.   reveal all of the subsequent identical description entries in the List file, 
  80.   which will show unique values in BX or other registers.  With the 'feature' 
  81.   documented, and with awareness of how the search works, this should be a
  82.   minor inconvience. 
  83.    
  84.   The List file is always searched sequentially from the beginning in order 
  85.   to count the newlines and display the tally.  No pointers are used with  
  86.   the List files, and no binary search techniques are used.  The file buffer
  87.   segment offset is incremented by one following each byte compare, and
  88.   tested for zero to identify segment boundaries.  The aux timer vector is
  89.   unhooked/hooked and start/end crit section (2F 16 81-82 & 15 DE 1C-1B) is 
  90.   called for file reads and the search.  A time slice is released for DPMI
  91.   (Windows) and DESQview in idle loops.  The file reads are 8000h, with a 
  92.   compare of AX, CX for eof.  
  93.  
  94.   Memory is released, retaining 16Kb for the program, and 7 segs allocated  
  95.   for the file buffer.  Errors trapped are mem allocation, file too big, file 
  96.   not found, checksum, and crit.  Stack seg is 512 bytes.
  97.   
  98.   Please report any INTERVUE bugs or problems, and upgrade suggestions.
  99.  
  100.                                       Thanks,
  101.                                       Bob Williamson
  102.                                       CIS 76570,2752
  103.                 
  104.